home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_200 / 263_02 / readme < prev    next >
Encoding:
Text File  |  1990-02-13  |  10.6 KB  |  304 lines
  1.  
  2. Welcome to the Marietta Systems "c_wndw" and "c_ndx" shareware libraries
  3. ========================================================================
  4.  
  5. This libraries for Turbo C and Quick C provides windows, menus, formatted 
  6. entry, file access, indexed file, and relational database functions.  The 
  7. libraries make it easy to write C programs of professional appearance, 
  8. quality and performance.
  9.  
  10. To print out this document type:
  11.  
  12.  TYPE A:README > PRN
  13.  
  14.  
  15. The Manual
  16. ==========
  17.  
  18. The shareware manual for this set of software will be found in file 
  19. 'MANUAL' and is 31 pages long.  To print it out type:
  20.  
  21.  TYPE A:MANUAL > PRN
  22.  
  23.  
  24. Installation
  25. ============
  26.  
  27. To install the software:
  28.  
  29.  for Turbo C - Put the first diskette in drive A: and type A:TURBOC
  30.  
  31.  for Quick C - Put the second diskette in drive A: and type A:QUICKC
  32.  
  33. The software will then install on to the default hard disc drive. 
  34. Installation to diskette will require some changes to these batch files.
  35.  
  36. Both the installation batch files create a directory MARIETTA.  Copy the 
  37. sample *.C programs into this directory.  For TurboC you should also copy
  38. the *.PRJ files, and for QuickC the *.MAK files.
  39.  
  40.  
  41. Bulletin board and ARC-issued software update:
  42. ==============================================
  43.  
  44. The install programs are designed to install from the diskette drive A:. 
  45. When you un-ARC the software you should copy it to a diskette, or amend the 
  46. install program to work from your hard disc!
  47.  
  48. Roger Stringer       Marietta Systems, Inc.     (404) 565-1560
  49.  
  50.  
  51. Table of contents
  52. =================
  53.  
  54. 1. Registration
  55. 2. Hints and recommendations
  56. 3. The sample programs
  57.  
  58.  
  59. 1. Registration
  60. ===============
  61.  
  62. Shareware is a software marketing concept that allows potential users
  63. of a software product to thoroughly test and investigate it before
  64. committing to license it.  The concept is nicknamed "try before you buy".
  65.  
  66. A true shareware version of a product is fully featured software, not 
  67. "crippleware", and the "c_wndw" and "c_ndx" libraries are excellent
  68. examples of this.  The only feature specific to the shareware is the
  69. shareware message window that appears at the start of each program.
  70.  
  71. If you like and use the "c_wndw" and "c_ndx" libraries, please subscribe
  72. and get the full benefits of being a registered user.
  73.  
  74. When  you  subscribe  to  the Marietta Systems' "c_wndw" and "c_ndx" 
  75. software you are entitled to the following:
  76.  
  77. a) A copy on 360 Kbyte 5.25" diskette(s) of the latest version of the 
  78.     software for Borland and Microsoft C compilers with:
  79.  
  80.     * Both medium and large memory models 
  81.     * Enhanced facilities of the "c_wndw" and "c_ndx" software
  82.     * Additional sample programs including programs to create index files,
  83.       to modify the dBASE data dictionary, and edit indexed files
  84.     * The software includes disk caching facilities
  85.     * Removal of the shareware banner at the start of each program
  86.  
  87. b) The official manuals for Marietta Systems' "c_wndw" and "c_ndx" 
  88.     software that features:
  89.     
  90.     * A tutorial on the use of the "c_wndw" and "c_ndx" functions
  91.     * Full description of the "c_wndw" and "c_ndx" functions with lots
  92.       of sample code
  93.     * Major section on customization
  94.     * Guidance on making full use of the software  
  95.     * Documentation on using the reserved functions
  96.     * Full error code analysis section
  97.     * Documentation of the key and function key usage    
  98.  
  99. c) Free phone support for the first 90 days for up to 1 hour of connect time.
  100.  
  101. d) A non-exclusive, non-transferable license to use the full version of the 
  102.     "c_wndw" and "c_ndx" software on a single computer system
  103.  
  104. e) Periodic newsletters
  105.  
  106. Registration fees
  107. -----------------
  108.  
  109. The normal retail price of the "c_wndw" and "c_ndx" object libraries is 
  110. $95.00, but shareware users can register for $79.00 plus shipping and 
  111. handling.
  112.  
  113. Source code licenses are available for $179.00 (normal retail price is 
  114. $195.00).
  115.  
  116. Shipping and handling is $4.50 for USA and Canada, $11.00 overseas.
  117.  
  118.  
  119. "c_wndw" and "c_ndx" libraries Registration form - 2.02
  120. -------------------------------------------------------
  121.  
  122. Mail to:            Marietta Systems, Inc
  123.                     "c_wndw" and "c_ndx" libraries
  124.                     P.O. Box 71506
  125.                     Marietta, GA  30007  USA
  126.  or Phone:          (404) 565-1560
  127.  
  128. Your name           ______________________
  129.     Company         ______________________
  130.     Street          ______________________
  131.     Suite/apt       ______________________
  132.     City            ______________________
  133.     State/prov      _____     
  134.     Zip/postcode    ___________
  135.     Country         ___________
  136.  
  137. Phone number        (_____)__________
  138.  
  139. Where did you get the shareware software?______________________
  140.  
  141. Your computer:
  142.     System model    ____________________     (ex; IBM PC/XT)
  143.     Hard disc MByte _________                (ex; 20MB)
  144.     Memory in Kbyte _________                (ex; 512 KB)
  145.     Color or Mono?  _________
  146.     Monitor adapter _________                (ex; CGA)
  147.     Printer         _________                (ex; Okidata 192+)
  148.     Operating system  ____________           (ex; MS/DOS v3.10)
  149.           (please specify version number)
  150.  
  151. Please enclose payment in US Dollars for the following amount:
  152.      
  153.                                     Qnty       Price
  154. Object libraries (including S&H)
  155.      USA and Canada at $83.50       ____   ___________
  156.      Overseas at $90.00             ____   ___________
  157.  
  158. Source code license (including S&H)
  159.      USA and Canada at $183.50      ____   ___________
  160.      Overseas at $190.00            ____   ___________
  161.  
  162. Georgia residents add sales tax            ___________
  163.  
  164. Total enclosed (in US funds)               ___________
  165.  
  166. You can pay with a check or money order. We also accept VISA and Mastercard:
  167.     Card number     ________________________ Expiry __/__
  168.     Signature       ________________________
  169.  
  170. Are you interested in reselling the libraries?  ________
  171.  
  172. I need software issued on 3.5" diskettes        ________
  173.  
  174. Note: We may not be able to ship to some overseas countries.
  175.  
  176.  
  177.  
  178. 2. Hints and recommendations
  179. ============================
  180.  
  181. 2.a. Microsoft C 
  182. ----------------
  183.  
  184.  When using the QuickC debugger or Codeview you may notice that some key 
  185.  entries go astray.  This is a problem with Microsoft C.  You can get around
  186.  this by setting SAVEWAIT to zero during the debugging sessions.
  187.  
  188.  The libraries require QuickC version 2.0 or equivalent Microsoft C 5.x.  The 
  189.  libraries do not work with Microsoft C 4.x or earlier versions.
  190.  
  191.  If you have QuickC 1.0, the sample programs will probably compile and work,
  192.  but with linker errors.  We recommend you upgrade to the vastly superior
  193.  QuickC 2.0!
  194.  
  195.  The MAK files are very useful, but you will probably need to modify them
  196.  before you can use them.
  197.  
  198.  By the way, when you register we supply a QuickC QuickHelp format file.
  199.  
  200. 2.b. Turbo C
  201. ------------
  202.  
  203.  The libraries require Turbo C 2.0.  If you have 1.0 or 1.5, the sample 
  204.  programs will probably work with linker errors, but 2.0 is strongly
  205.  recommended.
  206.  
  207. 2.c. ASP
  208. --------
  209.  
  210.  These libraries are produced by Marietta Systems, a member of the Association
  211.  of Shareware Professionals (ASP).  ASP wants to make sure that the shareware
  212.  principle works for you.  If you are unable to resolve a shareware-related
  213.  problem with an ASP member by contacting the member directly, ASP may be able
  214.  to  help.  The ASP Ombudsman can help you resolve a dispute or problem with
  215.  an ASP member, but it does not provide technical support for members'
  216.  products. Please write to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA
  217.  98006 or send a Compuserve message via easyplex to ASP Ombudsman 70007,3536.
  218.  
  219. 3. The sample programs
  220. ======================
  221.  
  222. .PRJ and .MAK files are provided with the sample programs to assist you 
  223. compile and link these programs under the Turboc and QuickC environments.
  224.  
  225. The sample programs should be compiled under the medium memory model, to
  226. match the MC_WNDW.LIB and MC_NDX.LIB libraries supplied on this shareware
  227. software issue.
  228.  
  229. 3.a. HELLO.C
  230. -------------
  231.  
  232. The classic understanding of a C language environment is a small program
  233. to display the message "hello world" to the screen.  The HELLO.C program
  234. is this small program.  It opens a window on the screen and displays the
  235. "hello world" message.
  236.  
  237. 3.b. WINDOW.C
  238. -------------
  239.  
  240. The program shows the creation and removal of overlapping windows.  If you
  241. have a color screen notice the automatic change of colors between windows.
  242.  
  243. The "c_wndw" libraries makes and removes windows extremely quickly, and 
  244. a half second delay is built into the program between each window.
  245.  
  246. 3.c. MENU.C
  247. -----------
  248.  
  249. The program shows the use of the menu() function with a simple menu in a 
  250. floating window.  It also shows the use of the flt_wndw() function.
  251.  
  252. 3.d. MESSAGE.C
  253. --------------
  254.  
  255. The program shows the use of message and query windows with the err_wndw()
  256. and qry_wndw() functions.  It also shows the use of the acptint() function
  257. to enter an integer value from the keyboard.
  258.  
  259. 3.e. DATETEST.C
  260. ---------------
  261.  
  262. The program shows the use of the date facilities under the "c_wndw" 
  263. libraries.  The system date is read and can be subsequently modified
  264. through the keyboard by the accept() function.  It also shows the use
  265. of the set_keys() function to activate the "Esc" key.
  266.  
  267. 3.f. MONY.C
  268. -----------
  269.  
  270. The program shows the use of the mony functions.  The mony type is a
  271. variable with two implied decimal places that can contain any value in the
  272. range 9,999,999.99- to 9,999,999.99 .  This allows most monetary values 
  273. (ex: prices, financial computations) to be figured without the performance
  274. and rounding problems of doubles.
  275.  
  276. 3.g. WRITFILE.C
  277. ---------------
  278.  
  279. The program shows the use of file access functions to create a file with 
  280. a record size of 61 bytes.  You are prompted to enter the records which
  281. are written to the end of the field.
  282.  
  283. 3.h. READFILE.C
  284. ---------------
  285.  
  286. The program reads the file created by the WRITFILE.C program.  The file is
  287. read by record number.
  288.  
  289. 3.i. DBREAD.C
  290. -------------
  291.  
  292. The program reads sequentially through an indexed dBASE file and displays
  293. a field from the file.  The data file is opened with the fileopen() 
  294. function, and the index file with the ndxopen() function.  The records 
  295. are read with the ndxread() function, and the field displayed with the 
  296. dispdbf() function.
  297.  
  298. 3.j. DBUPDATE.C
  299. ---------------
  300.  
  301. The program opens an indexed dBASE file and allows you to read forwards 
  302. and backwards through it to view and modify the records.  A further option
  303. is to add new records to the file.
  304.